﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="The .settings command sets, modifies, displays, loads and saves settings in the Debugger.Settings namespace."/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>.settings (Set Debug Settings)</title>



<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(2181);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/_settings__set_debug_settings_.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="_shell__command_shell_.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="_show_read_failures.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="debugger_commands.htm">Debugger Commands</A> &gt; <A href="meta_commands.htm">Meta-Commands</A> &gt; </div>
	<div id="winchm_template_title">.settings (Set Debug Settings)</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>The <b>.settings</b> command sets, modifies, displays, loads and saves settings in the  Debugger.Settings namespace.</p>
<pre class="syntax"><b>.settings set  </b><b>namespace.setting=value</b>
<b>.settings set </b><b>namespace.setting+=value</b><b> </b>
<b>.settings save </b>[<b>file path</b>] 
<b>.settings load </b><b>file path</b><b></b>
<b>.settings list </b>[<b>namespace</b>][<b>-v</b>]
<b>.settings help </b>  </pre>
<h2><a id="ddk_meta_set_symbol_path_dbg"></a><a id="DDK_META_SET_SYMBOL_PATH_DBG"></a>Parameters</h2>
<p><b>.settings set parameters</b></p>
<p></p>
<dl>
<dt><a id="_______namespace.setting_value______"></a><a id="_______NAMESPACE.SETTING_VALUE______"></a>       <b>namespace.setting=value</b>      </dt>
<dd>Sets or modifies a setting. When specifying file paths use slash escaping, for example C:\\Symbols\\.<p>Examples:</p><code>.settings set Display.PreferDMLOutput=false
</code><p></p><code>.settings set Sources.DisplaySourceLines=true</code><p></p><code>.settings set Symbols.Sympath="C:\\Symbols\\"</code></dd>
<dt><a id="_______namespace.setting__value______"></a><a id="_______NAMESPACE.SETTING__VALUE______"></a>       <b>namespace.setting+=value</b>      </dt>
<dd>Specifies that the new value will be appended  to (rather than replace) the previous value. <p>Example:</p><code>.settings set Extensions.ExtensionSearchPath+=";C:\\MyExtension\\"
</code></dd>
</dl>
<p><b>.setting save parameters</b></p>
<p></p>
<dl>
<dt><a id="_______file_path______"></a><a id="_______FILE_PATH______"></a>       <b>file path</b>      </dt>
<dd>
<p>Saves all of the values in the Debugger.Settings namespace to the specified XML file.</p>
</dd>
<dt><a id="_______none______"></a><a id="_______NONE______"></a>       <b>none</b>      </dt>
<dd>
<p>If a file path is not provided, the settings will be saved to the last file that was loaded or saved to. If a previous file does not exist, a file named config.xml will be created in the directory that the debugger executable was loaded from.</p>
</dd>
</dl>
<p></p>
<p><b>.setting load parameters</b></p>
<p></p>
<dl>
<dt><a id="_______file_path______"></a><a id="_______FILE_PATH______"></a>       <b>file path</b>      </dt>
<dd>
<p>Loads all the settings from an XML settings file. Loading settings will change only the settings that are defined in that file. Any previously loaded or changed settings that do not appear in that file will not be modified. This file will be treated as your default save path until the next save or load operation.</p>
</dd>
</dl>
<p></p>
<p><b>.setting list parameters</b></p>
<p></p>
<dl>
<dt><a id="_______namespace______"></a><a id="_______NAMESPACE______"></a>       <b>namespace</b>      </dt>
<dd>
<p>List all settings in the given namespace and their values.</p>
</dd>
<dt><a id="_______-v______"></a><a id="_______-V______"></a>       <b>-v</b>      </dt>
<dd>
<p>The –v flag causes a description of the setting to be displayed.</p>
</dd>
</dl>
<p><b>.setting help parameters</b></p>
<p></p>
<dl>
<dt><a id="_______None______"></a><a id="_______none______"></a><a id="_______NONE______"></a>       <b>None</b>      </dt>
<dd>
<p>Lists all of the settings in the Debugger namespace and their description.</p>
</dd>
</dl>
<p></p>
<dl>
<dt><a id="_______Namespace______"></a><a id="_______namespace______"></a><a id="_______NAMESPACE______"></a>       <b>Namespace</b>      </dt>
<dd>
<p>Lists all settings in the given namespace and their description.</p>
</dd>
</dl>
<p></p>
<h3><a id="Environment"></a><a id="environment"></a><a id="ENVIRONMENT"></a>Environment</h3>
<table>
<tr>
<td>
<p><b>Modes
         </b></p>
</td>
<td>
<p>user mode, kernel mode</p>
</td>
</tr>
<tr>
<td>
<p><b>
          Targets</b></p>
</td>
<td>
<p>live, crash dump</p>
</td>
</tr>
<tr>
<td>
<p><b>Platforms</b></p>
</td>
<td>
<p>all </p>
</td>
</tr>
</table>
<p> </p>
<h3><a id="Additional_Information"></a><a id="additional_information"></a><a id="ADDITIONAL_INFORMATION"></a>Additional Information</h3>
<p>On launch, the debugger will load all the settings from config.xml in the directory the debugger executable is in. Throughout your debugging session you can modify settings using the previous settings command (like .sympath or .prefer_dml) or the new .settings commands. You can use ‘.settings save’ to save your settings to your settings configuration file. You can use the following command to enable AutoSave. </p>
<p><code>.settings set AutoSaveSettings=true</code></p>
<p>When auto save is enabled, the settings in the Debugger.Settings namespace will be  automatically saved when exiting the debugger.</p>
<h2>Remarks</h2>
<p> You can exchange debug xml settings files with others  to duplicate their debug settings. 
</p></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
